[AFF-BACKEND-004] Создать метод GET /api/v1/affinity/suggestions

Разработка высокоскоростного геттера продуктовых рекомендаций в корзине

Author

Services Task & Simulation Framework Documentation

Published

July 13, 2026

NoteКраткая карточка задачи
  • Репозиторий / Компонент: affinity-service (Домен Recommendation Domain).
  • Контракт метода: HTTP-эндпоинт GET /api/v1/affinity/suggestions.
  • Ссылка на Метод: Спецификация метода
  • Статус: Готово к реализации

  • Инструкция по шагам:
    1. На Шаге 6: Реализовать прием запроса от экрана корзины мобильного приложения. Обязательный Query-параметр: product_id. Извлечь контекст текущего user_id из сессии.
    2. На Шаге 7: Выполнить быстрое чтение из Redis. Считать топ ассоциаций с наивысшим весом для данного product_id. В случае использования структуры ZSET, применить команду ZREVRANGEBYSCORE или ZREVRANGE с ограничением LIMIT 0 5 (вернуть топ-5 сопутствующих товаров).
    3. На Шаге 8: Смапить полученный список ID продуктов в красивый JSON-ответ и вернуть его на клиент со статусом 200 OK. Обеспечить деградацию функционала (Graceful Degradation): если Redis недоступен, эндпоинт должен мгновенно возвращать пустой массив [] без падения шлюза API.